home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 2.toast / pc / sample code / quicktime / quicktimeintro / createmovie / start code / qtsound.c < prev    next >
Encoding:
C/C++ Source or Header  |  2000-10-06  |  12.6 KB  |  474 lines
  1. /*
  2.     File:        QTSound.c
  3.     
  4.     Contains:    Sound code for QuickTime CreateMovie sample
  5.     
  6.     Written by:    Scott Kuechle
  7.                 (based heavily on QuickTime sample code in Inside Macintosh: QuickTime)
  8.  
  9.     Copyright:    © 1998 by Apple Computer, Inc. All rights reserved
  10.     
  11.     Change History (most recent first)
  12.     
  13.         <2>        9/28/98        rtm        changes for Metrowerks compiler
  14.         <1>        6/26/98        srk        first file
  15.  
  16.  
  17. */
  18.  
  19. /************************************************************
  20. *                                                           *
  21. *    INCLUDE FILES                                          *
  22. *                                                           *
  23. *************************************************************/
  24.  
  25.  
  26. #if !defined(_MSC_VER) && _WIN32
  27.     #include <Win32Headers.mch>
  28.     #define TARGET_OS_WIN32            1
  29. #else
  30.     #include <ConditionalMacros.h>
  31. #endif
  32.  
  33. #if TARGET_OS_WIN32
  34.     #include <QTML.h>
  35.     #define    STRICT
  36.     #include <windows.h>
  37. #endif
  38.  
  39. #include <Resources.h>
  40. #include <FixMath.h>
  41. #include <Sound.h>
  42.  
  43. #include "CreateMovie.h"
  44. #include "QTSound.h"
  45.  
  46. /************************************************************
  47. *                                                           *
  48. *    TYPE DEFINITIONS                                       *
  49. *                                                           *
  50. *************************************************************/
  51.  
  52. typedef SndCommand *SndCmdPtr;
  53.  
  54. #if PRAGMA_STRUCT_ALIGN
  55.     #pragma options align=mac68k
  56. #elif PRAGMA_STRUCT_PACKPUSH
  57.     #pragma pack(push, 2)
  58. #elif PRAGMA_STRUCT_PACK
  59.     #pragma pack(2)
  60. #endif
  61.  
  62.     /* 'snd ' resource format 1 - see the Sound Manager chapter of Inside Macintosh: Sound
  63.         for the details */
  64.     typedef struct 
  65.     {
  66.         short format;
  67.         short numSynths;
  68.     } Snd1Header, *Snd1HdrPtr, **Snd1HdrHndl;
  69.  
  70.     /* 'snd ' resource format 2 - see the Sound Manager chapter of Inside Macintosh: Sound
  71.         for the details */
  72.  
  73.     typedef struct 
  74.     {
  75.         short format;
  76.         short refCount;
  77.     } Snd2Header, *Snd2HdrPtr, **Snd2HdrHndl;
  78.  
  79.  
  80. #if PRAGMA_STRUCT_ALIGN
  81.     #pragma options align=reset
  82. #elif PRAGMA_STRUCT_PACKPUSH
  83.     #pragma pack(pop)
  84. #elif PRAGMA_STRUCT_PACK
  85.     #pragma pack()
  86. #endif
  87.  
  88. /************************************************************
  89. *                                                           *
  90. *    FUNCTION PROTOTYPES                                    *
  91. *                                                           *
  92. *************************************************************/
  93.  
  94. static void QTSound_CreateSoundDescription (Handle sndHandle,
  95.                                             SoundDescriptionHandle sndDesc,
  96.                                             long *sndDataOffset,
  97.                                             long *numSamples,
  98.                                             long *sndDataSize );
  99. static long QTSound_GetSndHdrOffset (Handle sndHandle);
  100.  
  101. /************************************************************
  102. *                                                           *
  103. *    CONSTANTS                                              *
  104. *                                                           *
  105. *************************************************************/
  106.  
  107. #define    kOurSoundResourceID 128
  108.  
  109. #define    kSoundSampleDuration 1
  110. #define    kSyncSample 0
  111. #define    kTrackStart    0
  112. #define    kMediaStart    0
  113. /* 
  114. for the following constants, please consult the Macintosh
  115. Audio Compression and Expansion Toolkit
  116. */
  117. #define kMACEBeginningNumberOfBytes 6
  118. #define kMACE31MonoPacketSize 2
  119. #define kMACE31StereoPacketSize 4
  120. #define kMACE61MonoPacketSize 1
  121. #define kMACE61StereoPacketSize 2
  122.  
  123.  
  124. /************************************************************
  125. *                                                           *
  126. *    QTSound_CreateMySoundTrack()                           *
  127. *                                                           *
  128. *    Creates a QuickTime movie sound track & media data     *
  129. *                                                           *
  130. *************************************************************/
  131.  
  132.  
  133. void QTSound_CreateMySoundTrack (Movie theMovie)
  134. {
  135.  
  136. // Step 1.
  137. // Insert "TrackMediaVars.clp" here
  138.  
  139.     Handle sndHandle = nil;
  140.  
  141. // Step 2.
  142. // Insert "SoundDescriptionVar.clp" here
  143.  
  144.     long sndDataOffset;
  145.     long sndDataSize;
  146.     long numSamples;
  147.     OSErr err = noErr;
  148.  
  149. #if TARGET_OS_WIN32
  150.  
  151.     char path[MAX_PATH+1];
  152.     short resID;
  153.     FSSpec fsspec;
  154.  
  155.  
  156.         fsspec.vRefNum = 0;
  157.         fsspec.parID = 0;
  158.         GetModuleFileName( NULL, path, MAX_PATH+1);
  159.  
  160.         NativePathNameToFSSpec((char *)&path, &fsspec, 0);
  161.  
  162.             /* open our application resource file so we
  163.                 can access the Macintosh 'snd ' resource */ 
  164.         resID = FSpOpenResFile(&fsspec, fsRdPerm);
  165.         CheckError (ResError(), "FSpOpenResFile error" );
  166.  
  167. #endif
  168.  
  169.         // Get the sound
  170.         sndHandle = GetResource('snd ', kOurSoundResourceID);
  171.         CheckError (ResError(), "GetResource error" );
  172.         if (sndHandle == nil)
  173.         {
  174.             return;
  175.         }
  176.  
  177.         // Allocate memory for the sound description
  178.         sndDesc = (SoundDescriptionHandle) NewHandle(4);
  179.         CheckError (MemError(), "NewHandle error" );
  180.  
  181.         // Create the sound description that correctly describes the sound samples
  182.         // obtained from the 'snd ' resource.
  183.         QTSound_CreateSoundDescription(sndHandle, 
  184.                                        sndDesc, 
  185.                                        &sndDataOffset, 
  186.                                        &numSamples, 
  187.                                        &sndDataSize);
  188.  
  189.         // 1. Create the track
  190.         
  191. // Step 3.
  192. // Insert "NewMovieTrack.clp" here
  193.  
  194.         CheckError (GetMoviesError(), "NewMovieTrack error" );
  195.  
  196.         // 2. Create the media for the track
  197.  
  198. // Step 4.
  199. // Insert "NewTrackMedia.clp" here
  200.  
  201.         CheckError (GetMoviesError(), "NewTrackMedia error" );
  202.  
  203.         // 3. Establish a media-editing session
  204.         err = BeginMediaEdits(theMedia);
  205.         CheckError( err, "BeginMediaEdits error" );
  206.         
  207.         // 3a. Add Samples to the media
  208.  
  209. // Step 5.
  210. // Insert "AddMediaSample.clp" here
  211.  
  212.         CheckError( err, "AddMediaSample error" );
  213.  
  214.         // 3b. End media-editing session
  215.         err = EndMediaEdits(theMedia);
  216.         CheckError( err, "EndMediaEdits error" );
  217.  
  218.         // 4. Inserts a reference to a media segment into the track
  219.  
  220. // Step 6.
  221. // Insert "InsertMediaIntoTrack.clp" here
  222.  
  223.         CheckError( err, "InsertMediaIntoTrack error" );
  224.  
  225.         if (sndDesc != nil)
  226.         {
  227.             DisposeHandle( (Handle)sndDesc);
  228.         }
  229. } 
  230.  
  231. /************************************************************
  232. *                                                           *
  233. *    QTSound_CreateSoundDescription()                       *
  234. *                                                           *
  235. *    Creates a SoundDescription structure for a given sound *
  236. *    sample                                                 *
  237. *                                                           *
  238. *************************************************************/
  239.  
  240. static void QTSound_CreateSoundDescription (Handle sndHandle,
  241.                                             SoundDescriptionHandle sndDesc,
  242.                                             long *sndDataOffset,
  243.                                             long *numSamples,
  244.                                             long *sndDataSize )
  245. {
  246.     long sndHdrOffset = 0;
  247.     long sampleDataOffset;
  248.     SoundHeaderPtr sndHdrPtr = nil;
  249.     long numFrames;
  250.     long samplesPerFrame;
  251.     long bytesPerFrame;
  252.     SoundDescriptionPtr sndDescPtr;
  253.  
  254.         *sndDataOffset = 0;
  255.         *numSamples = 0;
  256.         *sndDataSize = 0;
  257.  
  258.         SetHandleSize( (Handle)sndDesc, sizeof(SoundDescription) );
  259.         CheckError(MemError(),"SetHandleSize error");
  260.         
  261.         sndHdrOffset = QTSound_GetSndHdrOffset (sndHandle);
  262.         if (sndHdrOffset == 0)
  263.         {
  264.             CheckError(-1, "QTSound_GetSndHdrOffset error");
  265.         }
  266.  
  267.         /* we can use pointers since we don't move memory */
  268.         sndHdrPtr = (SoundHeaderPtr) (*sndHandle + sndHdrOffset);
  269.         sndDescPtr = *sndDesc;
  270.  
  271.         sndDescPtr->descSize = sizeof (SoundDescription);
  272.         /* total size of sound description structure */
  273.         sndDescPtr->resvd1 = 0;
  274.         sndDescPtr->resvd2 = 0;
  275.         sndDescPtr->dataRefIndex = 1;
  276.         sndDescPtr->compressionID = 0;
  277.         sndDescPtr->packetSize = 0;
  278.         sndDescPtr->version = 0;
  279.         sndDescPtr->revlevel = 0;
  280.         sndDescPtr->vendor = 0; 
  281.  
  282.         switch (sndHdrPtr->encode) 
  283.         {
  284.             case stdSH:
  285.                 sndDescPtr->dataFormat = kRawCodecType;
  286.                 /* uncompressed offset-binary data */
  287.                 sndDescPtr->numChannels = 1;
  288.                 /* number of channels of sound */
  289.                 sndDescPtr->sampleSize = 8;
  290.                 /* number of bits per sample */
  291.                 sndDescPtr->sampleRate = sndHdrPtr->sampleRate;
  292.                 /* sample rate */
  293.                 *numSamples = sndHdrPtr->length;
  294.                 *sndDataSize = *numSamples;
  295.                 bytesPerFrame = 1; 
  296.                 samplesPerFrame = 1;
  297.                 sampleDataOffset = (Ptr)&sndHdrPtr->sampleArea - (Ptr)sndHdrPtr;
  298.             break;
  299.  
  300.             case extSH:
  301.             {
  302.                 ExtSoundHeaderPtr extSndHdrP;
  303.  
  304.                     extSndHdrP = (ExtSoundHeaderPtr)sndHdrPtr;
  305.                     sndDescPtr->dataFormat = kRawCodecType;
  306.                     /* uncompressed offset-binary data */
  307.  
  308.                     /* we typecast a long to a short here, and it should really be fixed */
  309.                     sndDescPtr->numChannels = (short)extSndHdrP->numChannels;
  310.                     /* number of channels of sound */
  311.                     sndDescPtr->sampleSize = extSndHdrP->sampleSize;
  312.                     /* number of bits per sample */
  313.                     sndDescPtr->sampleRate = extSndHdrP->sampleRate; 
  314.                     /* sample rate */
  315.                     numFrames = extSndHdrP->numFrames;
  316.                     *numSamples = numFrames;
  317.                     bytesPerFrame = extSndHdrP->numChannels * ( extSndHdrP->sampleSize / 8);
  318.                     samplesPerFrame = 1;
  319.                     *sndDataSize = numFrames * bytesPerFrame;
  320.                     sampleDataOffset = (Ptr)(&extSndHdrP->sampleArea) - (Ptr)extSndHdrP;
  321.             }
  322.             break;
  323.  
  324.             case cmpSH:
  325.             {
  326.                 CmpSoundHeaderPtr cmpSndHdrP;
  327.  
  328.                 cmpSndHdrP = (CmpSoundHeaderPtr)sndHdrPtr;
  329.                 /* we typecast a long to a short here, and it should really be fixed */
  330.  
  331.                 sndDescPtr->numChannels = (short)cmpSndHdrP->numChannels;
  332.                 /* number of channels of sound */
  333.                 sndDescPtr->sampleSize = cmpSndHdrP->sampleSize;
  334.                 /* number of bits per sample before compression */
  335.                 sndDescPtr->sampleRate = cmpSndHdrP->sampleRate;
  336.                 /* sample rate */
  337.                 numFrames = cmpSndHdrP->numFrames; 
  338.                 sampleDataOffset =(Ptr)(&cmpSndHdrP->sampleArea) - (Ptr)cmpSndHdrP;
  339.                 
  340.                 switch (cmpSndHdrP->compressionID) 
  341.                 {
  342.                     case threeToOne:
  343.                         sndDescPtr->dataFormat = kMACE3Compression;
  344.                         /* compressed 3:1 data */
  345.                         samplesPerFrame = kMACEBeginningNumberOfBytes; 
  346.                         *numSamples = numFrames * samplesPerFrame;
  347.                         
  348.                         switch (cmpSndHdrP->numChannels) 
  349.                         {
  350.                             case 1:
  351.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  352.                                                     * kMACE31MonoPacketSize;
  353.                             break;
  354.                             
  355.                             case 2:
  356.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  357.                                                     * kMACE31StereoPacketSize;
  358.                             break;
  359.                             
  360.                             default: 
  361.                                 CheckError(-1, "Corrupt sound data" );
  362.                             break;
  363.                         }
  364.                         
  365.                     *sndDataSize = numFrames * bytesPerFrame;
  366.                     break;
  367.                     
  368.                     case sixToOne:
  369.                         sndDescPtr->dataFormat = kMACE6Compression; 
  370.                         /* compressed 6:1 data */
  371.                         samplesPerFrame = kMACEBeginningNumberOfBytes; 
  372.                         *numSamples = numFrames * samplesPerFrame;
  373.                         
  374.                         switch (cmpSndHdrP->numChannels) 
  375.                         {
  376.                             case 1:
  377.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  378.                                                     * kMACE61MonoPacketSize; 
  379.                             break;
  380.                             
  381.                             case 2:
  382.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  383.                                                     * kMACE61StereoPacketSize; 
  384.                             break;
  385.                             
  386.                             default:
  387.                                 CheckError(-1, "Corrupt sound data" );
  388.                             break;
  389.                         }
  390.                         
  391.                         *sndDataSize = (*numSamples) * bytesPerFrame;
  392.                     break;
  393.                     
  394.                     default:
  395.                         CheckError(-1, "Corrupt sound data" );
  396.                     break;
  397.                     }
  398.                     
  399.                 } /* switch cmpSndHdrP->compressionID:*/
  400.                 
  401.                 break;  /* of cmpSH: */
  402.  
  403.                 default:
  404.                     CheckError(-1, "Corrupt sound data" );
  405.                 break;
  406.  
  407.         } /* switch sndHdrPtr->encode */
  408.         
  409.     *sndDataOffset = sndHdrOffset + sampleDataOffset; 
  410. } 
  411.  
  412.  
  413. /************************************************************
  414. *                                                           *
  415. *    QTSound_GetSndHdrOffset()                              *
  416. *                                                           *
  417. *    Returns an pointer to the first sound command in the   *
  418. *    sound resource                                         *
  419. *                                                           *
  420. *************************************************************/
  421.  
  422. static long QTSound_GetSndHdrOffset (Handle sndHandle)
  423. {
  424.     short howManyCmds;
  425.     long sndOffset = 0;
  426.     Ptr sndPtr;
  427.  
  428.         if (sndHandle == nil)
  429.         {
  430.             return 0;
  431.         }
  432.         sndPtr = *sndHandle;
  433.         if (sndPtr == nil)
  434.         {
  435.             return 0;
  436.         }
  437.  
  438.         if ((*(SndListPtr)sndPtr).format == firstSoundFormat) 
  439.         {
  440.             short synths = ((SndListPtr)sndPtr)->numModifiers;
  441.             sndPtr += ( sizeof(Snd1Header) + (sizeof(ModRef) * synths) );
  442.         }
  443.         else 
  444.         {
  445.             sndPtr += sizeof(Snd2Header);
  446.         }
  447.  
  448.         howManyCmds = *(short *)sndPtr;
  449.  
  450.         sndPtr += sizeof(howManyCmds);
  451.         /* 
  452.         sndPtr is now at the first sound command--cruise all
  453.         commands and find the first soundCmd or bufferCmd
  454.         */
  455.         while (howManyCmds > 0) 
  456.         {
  457.             switch (((SndCmdPtr)sndPtr)->cmd) 
  458.             {
  459.                 case (soundCmd + dataOffsetFlag):
  460.                 case (bufferCmd + dataOffsetFlag):
  461.                     sndOffset = ((SndCmdPtr)sndPtr)->param2;
  462.                     howManyCmds = 0;    /* done, get out of loop */
  463.                 break;
  464.                 
  465.                 default:/* catch any other type of commands */
  466.                     sndPtr += sizeof(SndCommand);
  467.                     howManyCmds--;
  468.                 break;
  469.             }
  470.         }/* done with all commands */
  471.  
  472.         return sndOffset;
  473. }/* of GetSndHdrOffset */ 
  474.